Skip to content

Add Developer Tools section and restructure AWS docs#691

Merged
peter-smith-phd merged 2 commits into
mainfrom
doc-234-restructure-developer-tools
Jun 15, 2026
Merged

Add Developer Tools section and restructure AWS docs#691
peter-smith-phd merged 2 commits into
mainfrom
doc-234-restructure-developer-tools

Conversation

@peter-smith-phd

@peter-smith-phd peter-smith-phd commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

LocalStack's developer tools are how teams get full value out of the emulator, but until now the documentation was scattered across the Capabilities and Tooling top-level sections, sitting next to one-time admin and install material. This made it hard to identify what developers should be using, versus what administrators should be using.

This PR introduces a dedicated Developer Tools section, placed immediately after Connecting, that collects everything a developer uses in their regular workflow. Admin and configuration material stays behind: Capabilities is renamed to Configuration, the leftover Tooling pages move under it, and the Tooling section is removed. The Configuration section is intentionally left as a grab-bag for now and will be cleaned up in a later restructuring effort.

Key changes

  • New Developer Tools section (wrench icon) with an Overview page and the following entries: Running LocalStack (LocalStack CLI, lstk, LocalStack MCP Server), Snapshots, App Inspector, Chaos Engineering, Security Testing, Lambda Tools, AWS Replicator, and Cloud Sandbox.
  • Two new overview pages authored from scratch: the Developer Tools overview and the Running LocalStack sub-section overview, each with section cards.
  • State Management renamed to Snapshots and moved into Developer Tools; App Inspector pulled out of the Web App section into its own top-level entry.
  • Capabilities renamed to Configuration, with the remaining Tooling pages (LocalStack SDKs, Extensions, DNS Server, Testing Utils, LocalStack Docker Extension, LocalSurf) relocated under it. The Configuration overview page was rewritten for its new contents.
  • Tooling section removed entirely, including its overview page.
  • Pages moved with git mv so history is preserved; all internal hyperlinks across the docs updated to the new locations.
  • Redirects updated in public/_redirects: existing redirect targets repointed to the new URLs (one hop), plus new old→new redirects for every moved page.
  • Icons and landing page: added Developer Tools and Configuration mappings in icon-loader.js; updated the AWS landing page cards.

Verified with npm run build: 391 pages build and the link validator reports all internal links valid.

Completes DOC-234

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 4, 2026

Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: a680bd6
Status: ✅  Deploy successful!
Preview URL: https://44dad509.localstack-docs.pages.dev
Branch Preview URL: https://doc-234-restructure-develope.localstack-docs.pages.dev

View logs

Comment thread src/content/docs/aws/developer-tools/running-localstack/index.mdx Outdated

@quetzalliwrites quetzalliwrites left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

tyvm for your contribution @peter-smith-phd

honestly this looks pretty great, i made a small fix but otherwise happy to merge

peter-smith-phd and others added 2 commits June 16, 2026 10:01
Collect the day-to-day developer tools (CLI, lstk, MCP server, snapshots,
app inspector, chaos engineering, security testing, lambda tools, replicator,
cloud sandbox) into a new top-level Developer Tools section. Rename Capabilities
to Configuration, move the remaining Tooling pages under it, remove the Tooling
section, and update icons, links, and redirects accordingly.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@peter-smith-phd peter-smith-phd force-pushed the doc-234-restructure-developer-tools branch from 4ae6ef5 to a680bd6 Compare June 15, 2026 22:05
@peter-smith-phd peter-smith-phd merged commit c215d45 into main Jun 15, 2026
1 check passed
gtsiolis added a commit that referenced this pull request Jun 16, 2026
The Developer Tools restructure (#691) moved the localstack-cli and lstk
pages under /aws/developer-tools/running-localstack/. Update the cross-links
in the generated CLI doc, its generator, and the lstk FAQ to match.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants